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•The matarUi Included Tn this functional 
', specif TcatJon r Including but not limited 
.to | Instruction tines ana operating 
speeds is for Information ouepises only, 
A|| sucn materia! ^s suoject to changa 
wjtnout notice, Concequeotly OGC nmKes 
no claim ana sna|| not oe |'| a o I e for its 
accuracy, 

Unless soec|f|ecj otherwise* the ter^s 
"RSX" and "KSX-li" l^ply "RSX-lin", 



INTRODUCTION 



C without j«onaraf zf r«T nystsrr, Integrity or aff|con c yJ, 

Peripheral device support Is NOT an Integra! c^t of **3 RSX 

executive, it Is proving by "orlvflngRJ T*rus" calico I/O 

Handler Tasks, wh| c n *^y oo developed or modified without nn 
Intimate Know|ege of tne executive coda, 

I/O reouasts are .n?de to logical I/O units, find aro "Mcped 
Into onyslcal device-unit references v|a a set cf "-^3vIcj 
assignments"', Each Task nas Its own s*»t of ass i in"«entsi and 
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they may pe 

the operator's console 



changed eltlier by the* Task |n execution, or from 



;T7Y)', 



An I/O reque 
Directive) 
(Logical jn| 
gnTti and If 
resident and 
fysua | !y tn 
for the |nd| 

The USX exec 

request, It 
ass I gn^ent » 
of the Hand I 



st |s nade >y Instructing the system (v|a System 

to aueue in I/O request for an |nd|cat; 

t MumoarJi If the LUfi Is assigned to a oh: 
the Handle* Task to -supoort that unit Is 
Initialize:, the request Is queued by nr 

e reqjestlvi TasK' s pr i or I ty> In a Fences 1 

cated ohys I :a | un 1 1 , .- 



;sd L'JN 
lysTcs i 

I o r 1 1 y 
it Tlst 



utlve does hot attempt to (nteroret th*» the 
only passes |t to an I/O Handler TasK per LL'N 
and the disposition of the request |s a function 
er Task (net the executive), 



When an I/O request 
returned Immediately 
course) to the request 
option of suspending 
request, or operating 

I/O completion may Be 
forms, (l). An ?ven 
<accqmcan| eci Py a deel 
comp I et j on, TasK fix 
WAITF3 C nirectlvQ) unt 
combination of Event 

word may he speclffe 
operation, Th|s wor 
reauest, a n q then c n e c 
service routine may 
Interrupt tne TasK's e 



0£VlCt: INGEPEMOEMCE 



? r 

4c 

i 



<ie 

o 

*e 



oueuedfor a TasK, control fs 
contingent upon Tas* nr I or I ty , "of 
a TasK, and tnat TasK always nas the 
oxecut I on, ynt 1 ! cofp I et i on of an I/O 
ynchronous ! y", 

cheated Tn any of three ootlnr.nl 
Flag may be specified to be sit 

atlon of a Significant Events at I/O 

utlon may be suspended (usjnq t * e 
an Indicated Event F|ay# rr IngTcai 

Flags, Is set,Cl3 (?) An I/O status 
tn 0e snt at completion of an 
may oe cleared before ^ueueing a 

d periodically, <3) a System Trap 

e Incuaed fn a Task which w[il 

cut|on upon I/n completion, 



I/O requests ara made to LOGICAL units, which are 
equl val encftd to PHYSICAL device-units via a "Logical Mnlt 
Table" (LuT)', Logical Units are represented oy Lexical Mnlt 
Numbers ( L L' N; s ) , and each L'JN is recresenten Dy an •'ntrv Tn a 
"Logical '- ! n[t Table" <Lt'T5, physical qev ! ce-un I ts ■_ are 
Fenres^ntod by entries |n a table cal|ed tne physical M,n 1 1 
Directory (PUD)', 



Cl3 The WaITFOR Olrectlve Provides an "QR" corns I n a t| on t 
a series of WAITFORs provides an "AND", 



and 
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The lonlca! /ohysfca I enu I va | encas are made by "ASSIGNlng 
LUNs to'DhvsTcal devTce-un ! ts, 

When a UJj* Ts assigned to a physical devf ce»gnl ti the 
coraspon 1 1 rig LUT entry (s|ot> Is sot to the address of the 
corresponding PUT entry, 

Whan a l'-'N, 's deassigned (assigned to NCNE>i the 
cor resnonding LUT s|ot Is zeroed', 




Physfcnj device- 
of any otnep LUT 



re" four mechanisms In RSX-110 (n which the select 1 
PHYSICAL 1/1 devlce-un|t can be alterea, They are 



INSTALL -- '"'hnn a Task fs iNSTALLefl (^C 3 or 3atch> 
jnto a svStSTii the number of U'JMs any tnn 
assignment of eac* ^av he specified", Assignment* 
to dev|ce-un|ts without resfaent I'analer Tas^s Ah^ 
NOT flag sea', 

REASSIGN -- This ^CR Function allows a TasK<s disk 
resident assT 3nT)Rnts to bo changed, Assignments 
to dev[ce-unlts wjtnout resident Hanaier Tas<<s art 
flagged', 

ASSIGN «•- This Directive allows a'TasK to change 
| ts -nenory resident i,jn assignments, Assignments 
to dev | ce-un | ts without resident Hanaier T as*s ar=; 
f laggea", 

REDIRECT -- This >'CX Function allows ALL request? 
o' an indicated PHYSICAL dov | ce-un I t to be 
redirected to anotr.ar PHYSICAL devlce-u^it, This 
Function Is Intended to serve in case of 
peripheral failure* ana ooes not Provide nor^a.iv 
useful devjea Independence because the redirection 
|s Independent of Task cr Lu>\, 
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execution, 



I/O REOUESTS 



I/O roauests are Hade by Tasks usfng either the "TUEUE I/O 
PER TASK ASSIGNMENT DIRECTIVE", or the "QUfciJC I/O P r R NCR 
ASSIGN^E'-'T 'DIRECTIVE". These directives are Identical 
exceot for tbo LUN assion^ents used to "a^ trt« l oci i ca S unit 
Into a physical unit', The former uses t^e Task's own LuT, 
and the latter (used to communicate wjtn trie console 
operator) uses the fiCR Dlsoatcn Task's L.UT, 



When a queue I/O Directive |s Issuedi 

If the I/O renuest 

Olrectlva Status Word 

negative to Indicate 

Indicates the cdgsa 

Directive Is acceotedf 

Into tne t h e aovlca-gn 

If Id I e» | s tr | nger«3d 

Offectlve status word is 



a check Is maae 

can be qijeg-edC?}', It It c»nno 

(requestor's virtual zero) I 

rejection* and the "tgat|ve 

for rejection, If the n l'E'J 

a request node 's f o r " e i and In 

t's request qgeue» 1 "n < ? Mandler 

Into serv-lcs, a-'d me recue 

set posit I vs (+.1 ) to In 



oeforrr.ance of the DIRECTIVE. An 
Status block may De specified to be 
(disposition) of the I/O request', , 



Event flag and 
set upon cot>„ 



to s^e 

v^ i .j a 

"er ;ec 
Tisk, 
*tr>r ' s 
* i ca*e 
an 1/0 
i et i on 




for eacn ohvsl ca I 

the l r II s^neiis 
device- 'j nit, 
the -il5h??t 
Rgouests cf 
In whicn c * e 

' Directive 
n e r Tact's 

assignments) ana u ;*5" (for queue c^r r^CH ass I gnnonts ) , with 
a Directive Parameter ^iock (0^3) of the following format: 



Ident 



C23 Tnore are several' reasons why. an I/O request cannot he 
OueueqJ (l) tne Indicated (,ufJ does not ex|sti (2) the LJ'J Is 
not assigned to a physical unit, (3) a Handier Tas< to 
service the nnyslcal device (s not r?sla rt nt, (4> t K e 
conditions for quou|ng soscl'led wore n ot net, or .(5) a node 
for the renuest aupue |s not avaI|&ol e i 
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PARE 



Wd, 00 — OIC (31 or 33) 4 CEFN3, 



Wd', 
Wd, 
Wd, 
Wd, 
Wd, 
Wd, 
Wd, 
Wd", 
Wd. 
Wd, 
Wd, 



01 
02 
03 
04 
05 

36 
07 
15 
11 
12 
13 



J/O Function cone, 
LUN & Cnueulna cond I t { ons] , 
lPf]orltyl 4 Unused Byt*, 
CAdciress of I/O Status •? 1 ocK3« 
parameter #1, 



parameter 
Par?. Tie tor 
parameter 
Parameter 
Parameter 
par amoter 



#3, 
#5, 
#7, 



The OUCUE I/O Directives are describee In the RSX-iiiD 
"DIRECTIVES SPEC", 



I/O .FUNCTION COOES 



While the 1 executive does not Interpret Function Codas, ft 
does recopnfze the Tow arier three bits of ALL, I/O Fyefitlsn 
Codes as t*e following "^unction Atrloutes"; 

8lt-2 -- No Rpturn function, . 
git-i -- r'esepvea, 
8|t-2 -- reserved, 



on 



returned zn the 

renuests 

I/O Rundown, 



Is one |n whlcn no status o r da*a 



fs 



A »'Mo Peturn" funct.. . .. 

returned zn the requestor, In these cases, 

renuests a"c EXIT hefore tn e Tr cojipletlgn without Invoking 



a TasK «ay auo'.'e 
without '-..->■■■-- 



The following Is a |Tst of I/O Function Co-ies reco-inizoa *y 
co^.T.on 'riandjer Tasks', It Is not a complete list Q f Function 
Codes (Any riandjef Task Tiay recoonfze any function co*e 
desired uv Its t.n~ I e.^enter ) out rather a list of code.": usoa 
where devjeed Independence is feaslbis ana practiced', 

WRITE LOGICAL RF.CORO {LINE) 

PRINT FILE 

ilEAD LOGICAL P£CG"n (LIME) 

REAO '.MTiOoT iQ'riQ CTTY) 

ATT ACM UNIT TO TASK 

OFCTAHH U"IT FROM TASK 

ALLOCATE DISK STORAGE 

OEALL^CAIF QJSK STORAGE 

TRANSFER IN 

LOAD TASK IHAGE •* 

TRANSFER OUT 

recok: TA«K " I M AGE »» 
OPEN PILE FOR INPUT 
OPEN FILE FOR OUTPUT 



Wd^jz 


0?04?1 


a?iw 


3?im 


0?14|2? 


0*2"^ 


0324i)«3 


033~iP 




0?34Jl 


004fl0-O 


0?4C"0l 


004400 


00500? 
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6*5400 CLOSE FILE 
0P6?0tf DELETE FILE 
006402 RENAME FILE 

** Executive functions performed Dy disk driver<s> 
on| y for executive , 

I/O STATUS BLOCK 



When I/O comolotfon status |s desired* t*e address of *n I/O 
Status 9|ock Is included !n t*e Queue J/0 D p ti f Th|s r taius 
Bjock consists of two words of the following for^atj 

Wd', 03 -- Status Value 5 Unused tfvte, 

Wd', 01 r- Length of transfer (in bytes) fir 

READ/WRITE .functions, and dsvlc? 

dapandent in ail other cases, 

The following Is a list of commonly returned i/o status 
va'luaSi All possible status values returned for a 
Particular aevlce> are described In the 3SX Spec for the 
Handlor TaSK that servlcas |t, 

A posltlva va|ua Tmniles successful cnmsjetloi* and a 
negative value Implies reject I on s of failure, Tha positive 
value returned |s usually one (+1), however other ocsitive 
values nav be used, v(z,, TTY Hanoi 3r Task Mentlfle" ^'i a 
A^ termination on }nput» and *U & *S termination on output", 

• 99 UNREC0G.MI2EO FUNCTION 

-10 INVALID AHD^tSS 

•20 INVALID PARArieTErMS) 

•30 UNIT ALREADY ATTACHED 



QUEUING MECHANISM 



When an I/O renuest T s Queued for a LU*', a request ^019 Is 

formea ani Inserted ov orlority fn the reauast !|st f«r :^e 

device-unjt to which the L'-'N Is assignees, T rt e foriat of t*e 
Request node Is as followsi 

m Forward |Tnkaqe, 

- Backward | Inkag", 

- STD address (TasK ID) i 
■ Al"L nooe adr of requestor* 

• Priority & Unuseo -Syta 

- L'-J.N & EFN, ' 

• I/O Function "ode, 
» I/O Status 3ioc* address, 



Wd, 


30 


WH, 


21 


Wd', 


32 


Wd, 


03 


Wrt, 


34 


Wd, 


05 


Wd, 


26 


wd, 


37 
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Wd, 


10 


m • 


Parameter 


#1/ 


Wd', 


11 


r* ** 


Parameter 


#3, 


Wd', 


12 


m • 


Parameter 


#3* 


Wd, 


13 


•> * 


Parameter 


#4, 


Wd, 


14 


•P «l 


parameter 


#5i 


Wd', 


15 


* * 


Parameter 


#6* 


Wd', 


16 


•> M 


Fir ameter 


*7, 



After a ronu^st no-^e In Inserted I" a dev| ce-un { t* s 
the four following operations causei or 



request 

aMi t H e 




Significant Event Is oeclared, 



Whan an I/O Handler Task |s 
Directive with Event F!ao one 
Event F|qg wnose setting s!*ou 
Task execution, Thus, an 



id 



W4lTF^fi 



X Issues a 

poeclfled a3 an tgsusl lyi th?) 
d cause resumption c f Han.-ijer 
Idle Hand|ar Task Is tr|ng«r»a 



Into service by the oueing of an I/O request for any of the 
Units It services, 

The I/O Reieusts Queued Counter Is a word |n the "I'D entry 



of the un|t *or. wnfch the request was cueu**, 
Incremented for' every reauest that 'is iueu*d far 
and Is provided for Hanijar Task usaco. 

sreclal purpose anc "ulti-unit 



T h |s count I 3 

the un i t, 

"ost Handler Tts'-cs 



do not use It, but some srecu. 

Handler Tasks can onerate *ore af f leo^tiy *|ta -nf- 
facility', The cegnt nay oe altered by the Handler TasH at 
any tjffe', 

The "I/O requests Pending 
of eyerv active Task, 
decremented to provide 
requests'. This Is uses 



"ount" Is a '-ore 
Th|s count Is 



n th* ATL 
Incremented 



an 



memory 1 f It 
requests', 



rxlTs or is aborted *M+r. 



node 

I/C 
to delay t^s freeing of Task's 

unsatisfied I/O 



Indication of pending 



Ououlno an I/O request Is a Significant Event because 

a posslnp cause for Task swltchlno. (r^notlon nr Hanni-r 

Task wnen It Is of a h|iner priority r .:mh t;v 

Task), Therefore, a Significant Event declaration l * ->aoe 

whenever an I/O reouest is Queued, 



I t Is 

ian- 
requestor 



C33 if a "*>o Return" function, Requests Pending count Is MOT 
Incremented, 
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HANDLER TASKS 



Under RS'X-UO, I/O |s suDported by "privileged Tasks" eal'iea 
I/O Handler Tasr<s,C4] These Tasks ars called privileged 
because they .lave access to (1) the PPp-JU external Pays, 
<2> tha executive's lists and tables, and <3) routines whose 
m|guse cou|d Interfere w|tn normal system iporatTon, 
Privileged Tasks are trustea not to destroy tne system under 
which triey run, 

I/O Hanajar Tasks consists of two sections! U) A "T a sk 
Teve'M'j nrd (2) an "Interrupt service routine", Tno Tasx 
Teyej portion of an I/O Hanalar Task runs as a normal T»sk, 
w|th its own context, and In a software orMrity 
mu 1 1 1 proaram-nj ng environment", Thfs part of a Handler Task 
generally Interfaces with the executive (viz, denueues 
requests) a n 1 oerforms the bulk of t n s I/O service, The 
Interrupt service routine part of a Handler Task runs o«r 
'hardware priority {asynchronous to the software priority 
mu 1 1 1 progr aim I ng system) In resoonse to a peripheral device 
Interrupt, Interrupt service routines run |n a position 
Independent environment, and generally do as little as 
possjole', 



Task nannes are dictated by convention so that thslr 
residency way bo conveniently control le'i, Ta<? n:\r?e- 



Handler 

tPQmQ ry 

of an I/O handler TasK always consists of a two character 

symbolic ^v I nher 1 1 n&re followea ov four o^ts (perlonrji, 

v|z.» The -fandler Task that supports OTJ thru OTn Js cal'lec 
. U • t • • • i 




Handle' Task residency |s controlled by 
Punct | ons , 



the f ol | owl no mcR 



LCAO -- Th J s *<CR Funct|on allows an operator tr 
cause I/O Handler Tasks to become reaiy to service 
I/O requests, Handler Tasks are . Indicated, ov 
soecl'yln'j symbolic peripheral na"es (v|z,, 
0T|i,P,CD), A partition and/or priority "'ay also 



C«n The system disk driver Is a part of the 
assembly, but appears as an I/O Handler Task, 



executive 
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be specified, If a Handler Task cannot be 
a rejection message |s output, 



oadedf 



UNLOAD -■» This MCR Function allows an operator to 
cause an I/O Handler Task to c^ase to service 
requests when Tt3 request aueue(s) are ex.pty, 
Thjs, of course, frees up me:nory f 

When a Handler Task Is loaded, Tt Initializes |tse|f ana 

Instructs the system (WAITFC3 Directive) to suspend Its 

execution until an 1/0 request is queued for tiie Hindler 
Task', 

I/O Handler Tasfcs are suop||mantad by two sets of "emory 
resident re-entrant subroutines: (i) a Handler Task t I br ar y # 
and (2) tne System Subroutines, 



The "Handler Library fs created (or not created) 
configuration (SS£N)> and provides routines that 
to the pioVp sof|stfcatea I/O service', vlz,« f!l* 
b |bcKj ng'/unb I ack I ng# access mothodsj etc, Tn 
Library *ust oa re-entrant, but not n 
Posltlon-lndapRndent', 

The Systftm Suoroutjnes are a part of tne executive 
and ajwavs exist', These suotol-'tl nes orov 
functions, most of which are co-^non to a|l Handl 
v|z", i feuusue an I/O raauost node, return a node t 
of available |fst ele^e^ts, etc, Tne ■ usa o 
Subroutines by Handler Tasks is uescrl^ed later, 



n t s y s 
n r e cj* 1 
3 1 r 'J c - 
e h a n i 
flcess i n 



asse'iih 
de ;i 



tne 



sys 



te^i 
~?n 
ure 
Mr 
r i y 

ly. 

sic 

co i 
ten 



wnen a "or 1 vf I eged Task" js INSTALLed Into a system t h e AS* 
contents for al| but the Task co f *e are determined a-«a 
recorded with tfte "r as *< s dlsW image, The cnnt^ti of : K e 
A5>R used for Task cods |s set ir-y the evecutive wnen tne r *«;K 
Is loaded (because the real adiress sp^ce |n *h|cn It fs 
loaded Is not fixed)', Tne follow] ig |s a description «f t*e 
virtual adarass space allocations t ASH usage) for I/O 
Handler Task level coae, 



Virtual locations 330!>00-iU7777 CASR") ire 
for Task level corte, ,\ote, th|s code |s I 
to 4K, 

Virtual locations 022^00-^77777 (Ao«s 1,2.3 
used for execution ©f fancier Llbrar'-' rog 
Note i the Handler Llorary |s limited to I2f.\ 

Virtual locations 1W0C-157777 (AS^s 4,5,6 
used to accoss tha executive's tacleSi.llst 
System Subroutines, Note -- tha syste- 



tab I es, 



poo 



and System Subroutines 



use*i 
| r. | ted 

) are 
t i nes', 

) are 
Si md 

I |ST3| 
cannot 



exceeds 12k, 
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Virtual locations 160fl0O-l77777 (AS^7) . ar* gsed to 
access the PDP«»11 External Paoe', 

While Interrupt service roytfnes are physically a Dart nf 
I/O Handler Tasks (usually a part of the same asserply), 
they are executed In Kernel mode, and under the kernel's 
ASP3', ThUSi interrupt service routines are written as 
position-Independent code (or written to run |n virtual 
address space F600S2«i577777 )', 

The kernel address space 1P000'!-177777 (ASPs 4,5,6,7) and an 
I/O Handler Task's (user space) " I0.^r3-l77777 are 
coTnoMently mapoerJ', l*,e,i The executive's tables, lists, a 
System Subroutines, and the external page are available to 
Interrupt service routines (kernel mode) as we|l as to a 
Handler** Tas* |eve| code (user mode), 



SAMPLE HANDLER TAS'< 

The foMowlna P0 P -U program Is a sample I/O Handler Task to 
support a single unit device eallec "LP" which nrfnts. 
directly from a requester's menory, The purpose of thi& 
sample program Is to Illustrate Handler Task construction, 
and does not represent oatlmal coae or a functional Handler 
Task', a | I coce unique to the da-fee (not present I v _*in 
existent peripheral) nas oeen omjtted, and In many cases 
registers are redundantly loaded', 

NOTE — This sample pro3ram |s Included for Illustration 
purposes on|y, It Is 9 xoected trat c.-.an as <orrh d -s 
radical) *||l ba made as sandier 
exoer|ence Is aafneo, '''hfs sarnie 
actual |ist|ng as soon as possible, 

The Drogra* Is usqt as an examole for tne remainder of this 
Spec, 



Task I ^p I Iment it i on 
| 1 | be r eo | acea oy an 



I GENERAL REGISTER DEFINITIONS 
f 

Rl = /4l 
R2 = *2 
P3 = %3 
R.Js%4 
R5s%3 
Sps*6 
PC*%7 
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I 

? GLOBAL (EXEC) SYMBOL REFERENCES 
t 

,GL08L ,',CINT JCONNECT INTERRUPT 

.GLOtfU , ,OI- v T JPISCONNECT I 'TTRRUPT 

.GLOBU ..DS'.IT IHECLARE 4 SET. 

' .GL03U , f CLEF 1 CLEAR EVF,NT FLAG(S) 1-16 

.GLOBU , ,STEF fSET EVENT FUJ(S) 1-16 

,GL03L ,'.03*0 ;?E«3'JE'JE AM I/O fEQUEST 

,GLOBl ,,ATI'N J ATTACH UMT 

•,6L0SU , f QTl»N J^ETACri UNIT 

.CLOBL , ,IOON M/0 ncriE 

.GLOBL ,,R.\TP JRTN NOTE TO POOL 

...CLOBL , ,FLSH JFLUSM QUEUED I/O REQUESTS 

,GLQ3L i',RNDN JRUN-DOMis DONE 



I 



,GL08L ..INTX UNTERRt.'PT SERVICE EXIT 
.GLOBL i.ROIO J ID OF TASK BEING RvNCOWN 



J 
I 
J 

R.T0*3« 

R,RP=36 
R.LUs;h 
R,EF=11 
R.FCn? 
R,SA=14 

R.PAsl* 



I/O "EO'JEST -None ENTRY DEFINITIONS 



SYSTEM TASK CIRECTORY ENTRY *0R {REQUESTOR 10) 
REQUEST PRIORITY 

LOGICAL UMf NU.MRER 

EVENT FLAG .NUMBER 

I/O FUNCTION COJF 

AQORESS (VIRTUAL) OF REQUESTER I/Q 'STATUS WO°D 

TE^-?YTE .REQEOST PARAMETER BLOCK 



I 

I DIRECTIVE PARAMETER BLOCKS (OPS'?) US£0 Fo« INI TI AL HAT 1?N 

I 

Dp91| 101, JSET-SYSTC^-TRA? Pic 

12 IPWR RECOVERY T"AP 10 

PrtRUP SERVICE ROUTINE ENTRY 



I 

0pB2t 



121, ISET-SYSTEM-TPAP DIC 
11 J I/O RUNDOWN TRAP n 
IORUN JSERVICE ROUTINE ENTR V 



VAIRAQLES 'JSED FOR INITIALIZATION 




2 
3 



IDEVICE 

I DEPENDENT 

I VARIABLES 



START -- HANDLER TASK ENTRY, HANDLE* 13 INITIALISED, 
AND THE INITIALIZATION CODE" IS THEN USED fOH STACK 
STORAGE, 



I 
I 

J 
I 
1 
STARTJ 



POWER-RECOVERY 
THE SYSTEM VIA 



MQV 



& I/O-R'JNOOWN SYSTEM TRAP* ARE Co^NECTtO TO 
'"^ET SYSTEM TRAP" DIRECTIVES, 

#QPB1,"(SP) 
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•EMT 377 

MOV- *OPB2^<SP) 

EMT 377 

AN INTERRUPT SERVICE ROUTINE Is CONNECTED TQ TRA? LOCATION 
240, AMD THE BASE OF THE SERVICE RCUM-'E'S ADDRESS SPACE 
IS SPECIFIED AS THE HANDLER TASK'S VIRTUAL ^ERO, 

IF THE SERVICE ROUTINE CANNOT P£ CONNECTED (ANOTHER 
INTERRUPT SERVICE ROUTINE IS CONNECTED ) i THE HANDLER 
TASK EXIT* S, 

y OV #240, Rid '. |TRAP ADR Tq rji 

MOV INTENT, Rl ILNTRY POINT TO Rl 

CLR R2 fSASE OF ADR SPACE TO R2 

.JSR PC,',, CI NT J CONNECT 

BV'C EXIT J EX IT IF .'W CONNECT A3LE 

'THE HANDLER TASK IS DECLARED RESIDENT, AMD ITS U''IT 
IDENTIFICATION TA3LE <UJT) IS INITIALIZED, 

IF NO UNITS FOR THE DEVKE EXIST, THE HANDLER TASK 
DISCONNECTS ?, EXITS, 

MQV #UIT|R3 IUNIT. ID TRL APR TO 30 

M'OV #1,R1 f NUMBER OF UNITS TO Rl 

' MOV #»LP|R2 . JOEVICE NAME TH R* 

JSR PCi', ,DS"T fOECLARE * SET 

aye DAEXIT 

INITIALISATION PECULIAR TO THE PERIPHERAL DEVICE 
9EING SUPPORTED IS NOT SHOWN, 

NOP JOEVICE 

NOP } DEPENDENT 

NOP I INITIALIZATION 

INITIALIZATION COMPLETED -- INSTRUCTIONS A*»D DATA 
PRECEDING THIS" LOCATION ARE NO LONGtR V EEDEG, T VJ E 
HANDLER T AS-<'S STACK IS EXTENDED TO UTILITUE 
THIS STORAGE, 

MOV PC,SP 

HANDLER TASK JS NOW IDLE AND READY TO DE-QUEUE REQUESTS 

THE HANDLER TASK'S EXECUTION IS SUSPENDED UNTIL <OR 
UNLESS) ITS EVENT FLAG ONE IS SET, 

THE TASK. WILL REMAIN SUSPENDED UNTIL AN I/O REQUEST IS 
QUEUED fVR 0V£ or THE UNITS SERVICED 3Y THE HANDLE'* TASK 
<A UNIT IDENTIFIED IN THE U J T > ', 
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f IF A SYSTEM TRAP OCCURS WHILE THE TASK IS WAITING FO 3 AN 

I I/O REQUEST' TO BE QUEUED, THE TRAP SERVICE ROUTINE WILL 

f. BE EXECUTED, 8UT THE TASK WILL REMAIN SUSPENDED, 

? 

IDLE1 

i 

HOV *'JFi,«<SP> fw'AlTFOR Z % ?\ *i 

CfJT 377 

\ TASS EXECUTION HAS RESUMED BECAUSE ITS £V£NT FLAG ONE MAS 
I BEEN SET, 

; 

I- THE EVENT FLAG IS CLEANED, A*?D AN' ATTEMPT TQ DEQUEUE' 

I A REQUEST FROM UM1T-3 (TW£RE IS ONLY C^t UNIT) 13 ~-k n Z\ 

I 

i IF A REQUEST IS DE-QUEUED, IT IS pRQCESSEu', IF A 

f REQUEST IS NOT OE-OUEUEO, THE HANDLER 3 ECO M ES I DIE', 

» .... 



I PUD E V !TRY ADR TO R2 
IFLAG I NO TQ R\ 
I CLEAR V PX 

fUNlT-S PU? ENTRY ADR TO R"> 
JKNA dUF ACR T-i Rl 
JOE-QUEUE ATTA M pT 
MOLE IF NO CE-QUEUE 

r 

J CONTROL ?S DISPATCHED To APPPOPRIATE SERVICE CODE PE^ 
r I/O FUNCTION CODEi WITH THE REQUEST NODE ADDRESS Pi Rl', 

; 

J IF THE. REQUESTED FUNCTION' CODE IS NOT RECGGNI2ED> AN 

; I/O STAU'S VALUE OF -99 IS RETURNED, 

I 

«OV R,FC(R1),R2 JSET I/O FUNCTION CODE IN R2 

CMP RJ?i*<!423 J WRITE FEWEST? 

RED WPTREC JYES -- WRTTE LI"E 

CMP H?, #3.403 JNO -- ATTACH °E n EUiT7 

REQ ATTPE° JYES -- ATTACH IT nElTa"HED 

CMP R?.,it2?.Z<» JNO • - DETACH REQUEST? 

REO DETRET I YES -- OETaCh jr ATTACHED 

CM? R2##-17777i}NO «- HAULER E V i T R£TUEST? 

9EQ EYTRET JYES -- FP'ISri SERVICE & E*IT 

^OV #*99,|R3 J\0 -- UN-'-ECGCMIiiED FVNCTIQM 

JMP UN'SUC 

f 

I WRITE PEOUEST — THE STARTING ADHRESS and LENGTH 

I OF THE LINE TQ BE WRITTEN ARE VALIDATED IF" "A Y » 

} THE LINE IS PRINTED, IF NOTi AN I/O STATUS VALUE 

I OF -IS IS RETURNED', 

1 

WRTREQ! NOP ) VALIDATION YET TO 



DEO?' 
? 

r 


i 




' *ov 

MQV 

JSR 


UIT+3,R'J 
#1*R1 
PC|', ,CLEF 


MQV ' 
MQV 
USR 
RVC 


UlT+iJ,R?l 
#»NA#R1 
PC» r , fOQRQ 
IDLE 
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NOP. J8E DETERMINED 
f ' 

I EVENT FLAG TWO IS CLEARED, THE PRINT OPERATION IS 
; STARTED, AND EXECUTION IS SUSPENDED "NTH, EVENT 
I FLAG TWO IS SET (BY INTERRUPT SERVICE ROUTINE)", 
f . '■ 

PFi\ PREFERENCE -POINT FOR PWR FAIL RECOVERY 

^OV UIT+3,Ra J'CLZAR INTERRUPT FUAG. 
MOV #2,R1 fFUAG IND TO HI 
JSR PC»', .CLEF {'CLEAR EF *2 

i ' . 

NOP JDEVICE 

NOP i OEPENOENT 

NOP J CODE TO 

NOP J START I/O 

i • 

; *OV *WF2#--<SP) JWAITFOR E,F', #2 
EMT 377 ■; 

* *■''■■■ 

PF2J IREFERENCE POINT FOR PWR FAIL RECOVERY 

I 

J REQUEST IS FINISHED RY SETTING THE REQUESTOR'S. 

I I/O STATUS WORD (IF SPECIFIED, AND EVENT FLAG 

I {IF INDICATED)', 

I 

M*OV 0EVSTS,R3 ^SUCCESSFUL COMPLETION? 

9PL 5UC JYES -* RETURN STATUS s +1 

9R UNSUC J NO -- RETURN DEVICE STATU* 

J 

I'ATTREQ -- UNIT I 5 ATTACHED TO REQUESTING TASK (UNLESS 

» IT IS ALREADY ATTACHED TO IT), 

I 

ATTREQI . m qV UIT + i3,Rn JUNIT-3 PUD ENTRY *OR TO R* 

JSR Pr,',,UUN. JATTACH UNIT 

9VS SMC HP SUCCESSFUL. RETUM STS=+1, 

mqv #-Ja,,R3 ;OTHERWISEi RETU"N STSs-3J, 

RR UNSUC 

J 

I DETREQ -- UNIT IS DETACHED FROM REQUESTING TASK (UNLESS 

I IT IS >JO T ATTACHEO), 

J 

DETREQ1 *OV U!T + a,R3 ;U''IT-F PUD ENTRY ADR TO R^ 

JSR PC/, .OT'JN JCETACH UNIT 

RVS SUC J IF SUCCESSFUL, RETURN STS=+1, 

MOV #-3fl,,R3 JOTHERWISEi RETURN STS = -3<3, 

BR UNSUC 
J 

f EXTREQ -- HANDLER TA3K EXIT REQUEST — CLEANUP <S EXIT 
'I 

EXTREQJ NQP JDEVICE 

WOP J DEPENDENT 

NOP | CODE TO 
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MOP J TERMINATE USAGE 

I' DECREMENT REQUESTS PENDING COUNT AND RETURN REQUEST >'OOE 

* MOV RKA,R1 JREQUEST NODE ADR TO Rt 
CLR R2 I NO DECREMENT ADJ 

MOV #1,R3 fSTATUS TO R3 

jsr PC*',, iodn ri/o DONE 

MOV RMA.R1 I'REQUEST NODE AQR TO RX 
JSR PC,', i R NTP JRTN NODE TO POOL 

PAEXIT ? fOISCQMNECT * EXIT 

MQV ' #240, R0 I'TRAP ADR Tq r* 

JSR PCi', ,OIMT {DISCONNECT INTERRUPT 

ExJTt >EXlT HANDLER TASK 

MOV 5i,,«(SP) I'EXIT DIRECTIVE 
EMT 377 

! SUC — FINISH SUCCESSFUL REQUEST, I/O STATUS IS ?ET T +1 
SUCi «OV . #*i|R3 I'SET I/O STA T US IN ^3 

J UNSUC -- FINISH UNSUCCESSFUL REQUEST, R3 CONTAINS STATUS*, 

1 

UNRUCI. 

MOV R*'A,R1 ' REQUEST *COE *D« TO Rl 
CLR R2 INC CUTS P J D AC J 
JSR PCi', iIODN {'I/O DN 

* m v RMA.R1 {'REQUEST NnjE AOR TO Rl 
JSR PC,', |RNTP {RTN NODE T POOL 

I VRNA' IS CLEARED To INDICATE "NO REQUEST DE-CUEUEO" To 
I THE I/O RUNDOWN TRAP SERVICE RCJTIN*, 

; if a* l/n rjvdowv SYSTEM TRAP OCCURRED WILE TH£ 
> PRESENT REQUEST vaS DE-iU£.UED, P'OICME I/O RJN- 
J OCWN COMPLETE 3Y RESUMING THE RUNDOWN TASK, 

I 

CLR RNA 

I 

TST ROFLAG 

9EO DEQ 
JSR PC#VfRNDN 
"BR OEQ 

J POWER RECOVERY SYSTEM TRAP — IF A, WRITE WAS STARTED 
J ANO NOT FINISHED, IT H'JST 9E REDONE, 
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I 

PWRUPI " 'CMP 3>SP,#PFl i'rrxi \IZ, PC ',LE, *?T2t ? 

BLT PWREX f.MO -- EXIT SYS TRAP 

CMP 5>SP|#PF2 > 

BGT PWREX J'WO .- EXIT SYS TRAP 

MOV #PF1|0SP ;Y.ES -- CAUSE I/O TO 3E REDONE 

MOV RG,i(SP> 

MOV Hl|i<SP) 

MOV : UIT+2,«T 

MO" #2>R1 

JSR PC/, ,'STEF JSET Z % r\ *2 

"OV <SP)+,R1 

MOV (SP)+,R3 



PW-^EXf 



MOV . *XST,-(SP) JEXIT SYSTEM TRAP ROUTINE 
EMT 377 



I I/O RUNDOWN SYSTEM TRAP 

* 

IQRUNI MQV H0,^SP> 
MOV »!.!IT + 3,^3 



I 



JSR .PC«;.FL3H (FLUSH' QUEUED REQUESTS 

T3T RMA 

OEQ IORR 

MOV K\'A,R0 

CMP R',"TO.<Ki3Ji,,ROIO 

ONE IORn 

INC RnFLAG 

BR IORX 
I 

IORRI JSR POi 4 M RNDN 

I 

IOPXi 

1 

MOV .(SP) + »Ra 

MOV #XST»-(SP) 

EMT 377 
I 
I TASK DIRECTIVE PARAMETER BLOCKS 

WFi? .BYTE 41', ,3 
1300331 

; 

WF2? .BYTE 41, ,3 

J 

XST? 103, 
I 

I TASK'S VARIABLES ■ 
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f 

RNA! 3 JREQUEST N'QOE ADDRESS 
ROFLAGJ 3 | I/O RUNDOWN FLAG 

I HANDLER TASK'S UNIT IEMHFICATION TABLE <O v LY ONE UNITl 

f 

UITt S JOUO ENTRY AQR-FO» UNTT-2 

t 

\ INTERRUPT 'SE^VIOF ROUTINE s- POSITION INDEPENDENT RO"HNF 
1 (RUNS UisTER KERNEL ASR3, WHICH IK SET AT, 3R 4* CLOSELY 
f PELOW AS POSSIBLE* THE BASE OF THE INTERRUPT SERVICE 
$ ROUTINE'S ADDRESS SPACE AS SPECIFIED WHE\' CONNECTED), 

f 

INTE^TJ "OR JDEVICE 

*JOP } DEPENDENT 

NOP J INTERRUPT 

MOP ) ' SERVICE CODE 

t 

\ SET INTERRUPT FLAG 
f .•-.-.. 

MOV R5W*(SP) 

MOV UlTt3|R0 

JSR PC.',,STEF J SET E.F', *2 

MOV • (SP)+#R0 
I - 
r EXIT INTERRUPT SERVICE ROUTINE 

r 

JMP ,', INTX. 

I 

OEVSTSJ ? JHAROWARE DEVICE STATUS 

J 

,END START 



HA'IOLER TASK INITIALISATION 

Handl'ar Task Initialization consists of connecting to c y«jt*m 
Traps and hardware I nterruot ( 5) # determining which 
devl ea-un | ts exist (often only onoJ and now sac^* Is 
Identified anrt declaring the Handier Tasn rosldsnt and *'b • e 
to de-dusuQ 1/0 requests, 

I/O Handler Tasks normally use two System Trass, pnwpr 
reoovory, and I/O rundown', These Fyst-jn Trans ^rovldu « 
me^na of Interrupting a handler Task's normal ooaratjnn 
whenever cower Is restored (after a oow^r fajluro), and 
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whenever a Task EXITS or Ts aborted with I/O reoucsts 
pendlnr, The System Trap service routines are connecter! to 
the system (as are aj'j System Traps) using tpa SET SYSTEM 
TRAP' Directive, 

i 
Most Handler Tasks require only one -Interrupt service 
foytlne, however* as "any a3 are desired -rav exist w|tnTn a 
Handler Task', connecting an Interrupt service routine to a 
hardware interrupt is Instructing the systan {\) to transfer 
control to an Indicated service routine whenever an 
Interrupt occurs vfa an Indicated Interrupt trap address, 
and (2) where the base of the interrupt service routine's 
address space Is to be set, 



A System Subroutine to connect to an Interrupt 
f o I lows; 



s called as 



RE 

Rl 
R2 
R3 
C 



V, 



Interrupt trap address* 

Entry point of service routine, 

Base of interrupt service adarass space, 

Bits 0-3 prescribe the states of Corqltlon "odes 

Z* & N at entry to Interrupt service routine* 



JSR PC'.CliNT 

When the connect is successful! CC-V (Condition Coda ''V") Is 
SET uoon subroutine .returnj. if unsuccessful* CC-^J is C^£\R 
upon r©tur n '. 

In most cases* when an Interrupt service routine cannot ne 
connected, the Handler Task cannot run* and It s i -no | y rxiT", 
However, the Handler Task can be coded to do wnatever Ts 
appropriate, 

In the sample oroqram* the Interrupt service routine 
references the "l.'nTt Identification Tab|e» < U I T ) , hut no 
other oart of the Tas/< outside of tne interrupt sorvlre 
routine, Hence, the base of the |nt«rrunt service routine 
could have bean set as high as 'UIT /r , It Is set at the 
Task's virtual zero to snow that; "Unless a nana|nr Task Is 
larger tha n 4k words, Inter rupt ■ serv Ice routine references 
do not restrict Handler Task layout"', 

When control |s transferred to an interrupt service routine, 
ASR3 Is set as close to the specified "base of [ntorrunt 
service aadress space" without excluding ]t, l,e,, virtual 
"location ?6'?3fl3 exists at a 32-word bound at or be|ow the 
location indicated In R2, 



A|| Handler Tasks provide soaco for a system-set "Unit 
I dont | f I cat f on Tahie", This tab I o consists of on°"word 
entries for each device-unit that the "analer Task can 
service', Words representing non-existent units (no P'J3 
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ex |sti nn 



Units 

These 

Identifiers when 



entry) are set to zero, Words reor esantl ng 

are sot to the coresoondlng WU Qntr ^ adaressos, 

addresses are normal fy used only as un|t 

making reauests of System Subroutines* however, tnev also 

ojbifde an access to a unit's PUD ontrv, which Is useful 

some soeclaj cases', 

A System Subroutine to Initialize this table and 
Handler T*sk resident and ready to de-queue 
ca| |ed as f o I lowsi 

R0 j- Device name (two ASCII characters'), 
Ri r- Maximum number of units (t»d|e size), 



n 



declare the 
requests |s 



JSR PCi,',0SUT 



The 



If at least one PUO. entry fof the soec|f?ed device 

CC-V Is SET upon subroutine return; If the dev|c 

not found in the PUOi CC-V is CLEA« uoon rjtu 

Hanaler Ta*k i* flawed resident in tn« PUD entry for each 

unit Identified to the Handler TasW, 



|s found, 

e name Is 

ro turn, 



IDLE STATE FOR HANDLER TASKS 




If a Powor .1 t-. * -■ 

whT !« a handler TasK Is Idle 
gn|oss the System Trao 
resumptl on, 



Rundown System Trap occurs 
, the TasK wl I ! rem.* In susoanded 
service routine caused Its 



I/O REHUEST PROCESSING 



When an Idle Handler Task's execution Is resumed 



Result of Its Event F|ag one being set) it normally 
that Flag before attempting to de-duau* a raauo 
however, In some special cases It Is desirable to ci 
Queue F|ag {Event Flag one) at other times, 

The CLEAR EVENT FLAG Directive could'be used, however 
the Privileged Task has access to the system's I 
System Subroutine Imposes less overhead (and can cleft 



(as a 

r, l«ars 
t, C^ 
the 



ear 



, stnee 
I" s 1 3 , a 
r 'nor e 



I/O OPERATIONS PAGE ?0 



than one flag)', a Subroutine to c|ear any of a Handler 
Task's Event Flags lsl6 |s called as fo||owsl 

R0 '•- PUD entry address (from UITJi 
Rl ?- Flags Indicator', 

w?R pc M ;ci,Er 

Ri b?ts 0-15 represent Event Flags 1-lft respectively', 

I/O requests for an Indicated unit are de-aueued by using a 
Subroutine to attempt to de-queue a request node, mis 
subroutine is called as follows; 

Rid i:. pud Entry address (from UIT) t 
Rl s* Address of buffer for "RNA", 

JSR PC, ,,DQRQ 

If this subroutine Ts called and the reauest |T3t for 
Indicated unit is empty! a request node Is »>ot de-oueuad (of 
course)'. A|soi even when a reauest list Is not emoty, It Is 
Possible to WOT be ao|e to de-queue a request because U) 
•the unit Is ATTACHed and no requests for the attaching Task 
are |n the list, and/or (2) requests |n the ||st have been 
made by a T§sk that Is checkpo Inted, 

When a request Is dequeued, the Request Node Address (RNM 
ts storeq In the Ouffer Indicated Jn ri, a "Requests In 
Process Count" is | ncremented, C63 and CC-?V js SET -joon 
subroutine return,, when a request Is NOT dequeued, CC-V Is 
Cl,EAR upon subroutine return', 

When a request node Is de-queued, Its address fs sot |n the 
calling Drogramfs buffer (nor Rl) wltn Interruots Inhibited', 
This |s done so that a non^zero RNA buffer can be used as a 
"request de-queued" f|ag', 



C53 To avoid the race condition that exists when a second 
request |s queued Just after a failure to de-queue ha3 
caused the Handler Task to become Idle again', 



E63 If "No Return" function, Requests In Progress Count Is 
NQT Incremented, 
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Normally after de-qUoufng a peauost, the I/O Function Code 
Ts examined, and control |s transferred to a routine to 
Perform the Indicated function, If the function Is not 
Recognized by the Handler Task* a status of -?99 (by 
convention) Is returned, 

If an ATTACH request Is de-queued, and the unit Is not 
already attached (to the requesting Task), the unit Is 
Massed for the exclusive use of the attaching Task', This 
e^yses the Oe»queue Request System Subroutine (,', DQRQ) to 
only de-queue requests for that Task', 

A System Subroutine to attach a unit Is called as foi'lowsf 

R0 ~.» PUD entry address (from UJT)» 
Ri «• Request node address*, 

JSR PCi"tiATUN 

When a unft Is attached, CCrV |s SET upon subroutine return', 
When a- unjt Is NOT attached, CC^V Is CLEAR uoon return, 

If a DETACH reoue3t Ts de-aueued, and the unft Is attached 
to the requesting Task, the ATTACH |s nullified, This 
causes the De-oueue Request System Subroutine <,,DQRO) to 
dequeue from the top (high priority? of the unit's request 
'list', 

A system Subroutine to detach from a unit Is called as 

f 0*1 | W 3 j 

R0 t- PUD entry address (from UIT 5 4 
Rl ••? Request node address, 

JSR PCi,',DTUM 

When a unft Js detachedj CC-v Is SET upon subroutine return', 
When a unft fs NOT detached, CC-v Is CLEAR uoon return, 



f-73 Unless "No Return" function", 
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Many J/0 requests require a transfer either to or from a 
requestor's memory! The range of these transfers must be 
validated (n order to maintain system Integrity, The 
f o'j' jowlns three subroutines a|d Tn this operation, 

A System Subroutine to validate a transfer and setup an 
18«bjt starting address (for a peripheral' controller) Is 
tailed as follows! 

R2 «« first word address (user virtual)* 
R3 m Transfer length {In bytes), 

JSR PCi,",VXFR 

If the transfer Ts Jnvalldi CC*V Is CLEAR upon subroutine 
return, If the transfer Is valldi CC«V Is SET upon return 
and the ls»t»T t starting address fs In R4 & R5' t The |ow 
order 16 b|ts are In R5, and the high order two bits are In 
b|ts 5 M of R4 wTth a|| other R4 bits o|eared r 

System Subroutines to validate a transfer, and Jf valid 
perform the transfer, are eaTled as follows} 

R2 ' •• FTrst word address (user v|rtua|)i 
R3 ••• Transfer length, (in words) i 
R4 ■•- Memory buffer address', 

„JSR PCi , ,BUXI Far transfer INt 

or 

JSR PC|,',SUXQ For transfer OUT, 

If the transfer is performed! COV Is SET upon subroutine 
return, If the transfer |s not performed, CC-V is C L EAR 
upon return, 

When an I/O operation is completed* an Event Flag and an I/O 
Status Word nay be set (If Indicated in reouest node), t*e 
requesting Taskls i/o Pending Cognt Is usually decremented, 
and Its Requests -In Progress Count |s decremented , C 3 3 

A System Subroutine to finish an I/O request Is called as 
follows; 

Ri ?• Request node address, 

R2 «•«• Adjustment to unity decrement! 

R3 «•- I/O. Status B|ocK Wd, 00, 

R« im J/0 Status B|0CH Wd, di\ 



C83 If "No Return" function, NEITHER. ooynt |s altered, 
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JSR PC,,/, JOOM 

If' an I/O Status B|oek address was specified In the request 
node, the status block (In the requestor's memory! M set to 
the contents of R3 5 84', 

if an Event Flag number was specified In the request node, 
that event flag Is set and a Significant Event Is declared, 

The I/O Requests Pending Coynt for the requesting Task f3 
decremented and then modified by adding the contents of R2 
to |t, R2 Is normally zero, however In some eases the 
dee ementlni nay be adjusted (viz,, R2 = *l for FILE OPEN" and 
R2»U for FILE CLOSE), Tn e ATTACK * DETACH subroutines 
modify a TaskJs J/0 pending count so that a request Ts 
•qnsldered pending while a unit Is attached to that TasK, 

When an I/O request node |s no longer needed by a Handler 
Task, Itis returned to the pool of available | j st e I enents. 
A System Subroutine to return a node to the Pool is canec 
as foj Iqwsi 

RJ, «- Request node address', 
JSR PQ,,,RNTP 

When an I/Q operation Is started whose termination 
signaled by a hardware interrupt, the Handler TasK may u 



Is 




service routine to signal completion', 

A Subroutine to clear any of a Handler Task's Event Flags 
l«to {s cal |ed as follows? 

R0 «• PUD entry address (from UlT'j 
Rl e- Flags Indicator, 

JSR PCi,',CLEr 
Ri bits 0-15 represent Event Flags 1*16 respectively', 

A Subroutine to sat any of a Handler Task's Event Flags I. 16 
Is ca| led *s follows l 

R0 t* PUD entry address (from UIT)| 
Rl r* FJ'ags Indicator', 

JSR PC,,',STEF 
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R% bT t9 0*15 represent Event Flags 1«16 respective |y", 

HANDLER TASK EXJT 

The UNLOAD MCR Function Is used to cause a a Hand|'er Task to 
• xTf, Th[s Is done by queuing a low priority request to the 
UnTt represented by the device's first PUD entry, and 
Inhibiting furthur queuing by declaring the Handler Task 
non-resident (In e*ch PUO entry?', The j/O function code for 
an exjt request Is 177771 {octal), 

In most sfnile^unft devloesi servicing an ex|* request 
consists of finishing the request (,', IODN & ', ,RNTP), 
disconnecting from hardware Interrupts! and EX{T|ng', More 
complex Handler Tasks require additional code to process all 
queued requests before EXJT|ng, 

WnTle a Handler Task Is In the process of EXlTlng* It cannot 
be peuloaded (the LOAD MCR Function will find It active)', 

I/O RUNDOWN 

» • ■ < 

When a Task EXITs or Is aborted with I/O requests pendTno, 
the Task Is considered active (ATL node and memory stfll 
•xfstj but not runabje, and a request to "rundown!? Its I/O 
Ts made (via send & REQUEST Directive) to a Task ca|'|ed 

"iiIPn" . 

The I/O Rundown Tasks requests Handler Tasks to flush nuoued 
Requests 'and either finish or abort any requests In process 
for an Indicated Task* by (1) clearing Its E^ent F|ag ono» 
<2) placing the Task*s STL node address In the SCO* word 
mRDIDi (3) causing an I/O Rundown System Trap for a 
Particular Handler Taski and (4) suspending Jts execution 
Until Its Event F-|afl one' Is set', 

When the Handler Task completes Tts I/O rundown sorvlcei It 
resumes the execution of the I/O rundown Task by setting It3 
Event F|ag one, 

A System Subroutine to set Event Flag one of a Task called 
n i'iIO»i" I s called as follows} 

JSR PCiViRNDN 

The I/O Rundown Task continues this process until either the 
Requests Pendlnc Count for the Task being rundown Is 
dooreanented to zero, or a|| devices have bean scanned (In 
which,, case something Is wrong< likely a bad nand|er)'t 
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k System Subroutine to flush a || requests from a device 
Request list fop the Task on which I/O Is being rundown (car 
SQQM) Is ca| led as fd| lowsi 

RB sf PUD entpy address (from U I T ) *, 
JSR PC|,',FU§H 



PQWER^FAIUURE RECOVERY 

When the system recovers from a power f aT luf •§ a Power 
Recovery System Trap js generated for all' Tasks that are 
setup to service the trao, 

I/O 'Handl'er Tasks are coded to do what ever is necessary to 
Recover, , In some cases 4 thTs Is simply repeating a request 
Tf a request was being processed; vjz,i tfagtaoe reaa, !n 
ether casnsj recovery Is determined by the degree of 
completion at dows? failure", vlz.i If power falls durfnq a 
Magtape wMte, the Handle? Task must determine wither 
anything was written and conditionally backspace before 
rewriting, 



